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GAS LANGE чш ма Е 
COMMAND DESCRIPTION 


ABS (X) absolute value of X 

APPEND "filename" | appends "Filename" from disk 
Ас (X) | decimal ASCII value of X | 
ATAN (X) arctangent of X | 


BASE | Establishes either O or 1 as BASE for 
array subseripting and random files 


CHAIN "filename" loads and begins execution 
of program "filename" 


CHR$ (OX) single character string equivalent 
То decimal ASCII value (X) 


CLOSE (disk) Close open disk files 

CLOSE (cassette) Close output cassette file. 

CONT | resumes execution after STOF or CTL C 
COS (X) | | nasite of X 

CREATE Create a random file 

DATA puts data values in data puffer 

ПЕЕ FNACK) i user defined fungtion 


DIGiTs=x sets number of digits to print on 
right side of decimal point 


DIM ACN) Seats dimension of array 
ENE ende execution and closes all files 
EOF | | End of file check far cassette files 
ЕХР OX) hase of natural logarithm raised 

to the ХЪЛ power 
FCHE Check absence or presence of disk file 
FIEL | Delete #11е(5) fram disk 


FLIST List disk fila directory 
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COMMAND 


FOR ~~ NEXT -- ЕТЕР 
FREE 

ЕКЕМ 

GET 


GUSLIE N 


GOTTE N 
HOME 


IF expi THEN expo 


IMOD са, в) 
INPLT 
INT 4X) 


|ЕЕТЪ (X$, N) 


LEN (X$) 
LET ХЕМ 


L.INE-X 


LIST, LISTX, LIST X-Y 


LOAD "filename" 
LOG X 


MIDS (A$, X, Y) 


MON 
NEW 
ON X GOTO/GOSUG N 


“ОРЕМ 


DESCRIPTION 


program 100 р 

Free sectors on disk 

Rename file on disk 

Get data from random disk file 


goes to subroutine at line N 
returns upon RETURN 


program branch to line N 


sends home-up, elear-end-of-frame 


оті Ті опа) execution of expz when 


expl is true 

remainder af A/B 

acceptas data from terminal 
greatest integer less than X 


String of characters from the left 
most to the Nth character of X$ 


number of characters in string ХФ 
assigns value M ta variable X 
defines print line length 

lists line af program 

loads program from disk 

natural log af X 


string of X through ХҮ characters 
from string A$ | 


return ta operating system 


clears program area 


if X is true branch ta M 


Преп disk file (random & sequential) 
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COMMAND 


OPENI 
ОРЕМО 
OPTION 
PEEK (X) 
FI 

POKE (X, Y) 
PORT=N 

| Р ne 

PRINT 

PUT 

READ (disk) 


READ X 


КЕСМЕ 
КЕМ 


REPLACE 
RESTORE (disk) 


RESTORE 
RETURN 


RIGHTS (ХФ, М) 


RJUST=X 


RND 
ЕМЕХТ 


RSIZE 
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DESCRIFTION 


Üpen cassette file for read 


Open cassette file far write 


Optional with ВАЗЕ 


|decimal value in memory loation X 


stores Value Y in memory location X 
Sats control port to М 

present print position 

prints to the output device 

outputs record to random file 

Read data from disk file 


assigns next value in data buffer 
to variable X : 


Record pointer in random file 


remark 


replaces program on disk with contents 


of program in BóSIC^s source buffer 


Resets disk file pointer to start 
(first record) of file 


resets data statement buffer pointer 


ands subroutine 


string of characters from the МЕН 
position to the left of the right 
most character of ХФ 


seats print justification for numeric 
variables to right-justify 


random number generator 


Next available record in random file 


Random disk file size (records) 


COMMAND 


RUN 


SAVE "filename" 
SCRATCH 
SET 

SGN (X) 
SIN (X) 
SRIP X 
SOR (X) 
STATUS 
STOF 
STRE (X) 
STRING=X 
TAB (X) 
там (X) 
TLOAD 


ТРЕМП 


TRACE- 


TREAD 
TSAVE 
TWRITE 
VAL CX) 
WAIT X 
WRITE 


CSS BASIE 


DESCRIPTION 

initializes program parameters and 
begins execution 

saves program "filename" ta disk 
Sets up file for output 

Assign value to RECNO fummand 

sign (+ or =) af X 

sine of X. 

skip X print lines 

square ront of X 

Disk file status (DFM) code 

ands program execution 

string value of numeric variable X 
sets maximum string length to X 
moves print position to X 

tangent of X 

load from tape 


leads from tape to end of current 
program | 


toggles the display of line numbers 
during program execution 


Cassette data file read 

Saves to tape 

Cassette data file write 

numeric constant equivalent to Х% 
wait state for X units af tima 


Outputs data ta disk file 


PAGE 


ё, 
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INTRODUCTION: 


Computerware^zs SUPER BASIC and RONDOM | BASIC were written to 
conform closely to the proposed ANSI standard, thus allowing the 
user to run standard BASIE programs with few if апу, changes 

In addition, many new commands have been added ta make 
“programming easier, and | to keep your souree code to a minimum. 

All commands, statements and functions can now be abbreviated and 
the line input buffer has been expanded ta 128 characters (70 
characters for cassette/prom) to allow the use of longer text 
strings and multiple statement lines. CSS BASIC supports many 
transeandental functions, allows programs and data to be saved on 
disk, and supparts both RANDOM and sequential data files. 


Complete documentation for input and autput character routines is 
provided so as to allow easy adaptation for special IZO features. 


LICENSE: 


Computerware BASIC, іп all machine readable formats, and the 
written documentation accompanying them аға copyrighted > The 
purzhase of CSS BASIC, ar the purchase of a disk system with 
whieh CSS BASIC is distributed without additional charge, conveys 
to the purchaser a license to copy BASIC for his/her own use, and 
nat. far sale or free distribution to others. Мо other license, 
expressed or implied is granted. 


WARRANTEE INFORMATION: 


The license То use CSS BASIC is sold AS IS without warrantee, 
This warrantee is in lieu of all other warrantees expressed ar 
implied. Camputarware does nat warrant the suitability of BASIC 
for any particular user application and will oot be responsible 
for damages incidental to its use in a user system, 


REGISTRATION: 


Computeruare wants you, the user to. be satisified with our 
products. To help achieve this goal, we ask that you fill aut the 
anclosed ORIGINAL registration form. if a problem is found in 
the software, ше can then communicate | with you cancerninog 
аакка: опе and enhancements. If you find a problem - please 
document it — send to Computerware the disk or tapes) with the 
software in question and we will make every attempt to resolve 
the problem/question. The materials you sent will be returned ta 
you with an explanation of what we found. 
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MODES OF EXECUTION: 


BASIC has two modes of execution ~= the immediate (Cor direct) made 


and the program moda. In the program mode, BASIC execules a set 
af. instructions that has been stored prior to executiori. In thee 
immediate mode, GASIC executes commands at the time they are 
entered from the terminal. : 


The BASIC interpreter determines whether a statement is intended 
for. immediate execution оғ for storage as part of the program 
solely оп the basis of whether or nat the statement was | entered 
with a line number. Statements having line numbers are stored 


far later execution those without line mumbers аға executed 


immediately. Thus the lins: 
10 PRINT "С55 BASIC" 


will produce no response at the terminal until the program is 
executed. The line: 


PRINT "Cis BASIC" 
however, causes the terminal То respond immediately with: 
C55 BASIC. 


By using statements without line numbers BASIC сап be used as а 
sophisticated calculator. For example, 


PRINT (1782 So) (7/40 


Another use for immediate mode execution is as an aid in program 
developement and debugging. Through the use of direct statement 
execution program variables can Бе read or altered, and the 
program flow may be directly controlled. | 


INETRUCTION ABBREVIATION: 


All instructions can be abbreviated by using only as many af. the 
first letters as required to provide uniqueness and then a period 
1.3. The most offen used instructions CPRINT, LIST, RUN, FOR, 
NEXT, GOTO, INPUT, THEN, ete.) only require their first letter 
and a period. Abbreviated instructions that occur right after 
the line number will be expanded to their full spelling, but all 
others within the program will remain abbreviated and. will bë 
processed faster than the full spelling format. | 


(С) 1978 COMPUTERWARE | Ж тз 


© 


сет BASIC 


PROGRAM STATEMENTS: 


A BASIC program is made of a series af program lines. Each line 
must begin with a line number followed by one or more BASIC 
statements and terminated with a carriage return. The following 
are several rules that must be followed іп writing а BASIC 
program: | 


1. Every line must have a line number ranging between 1 and 
9999. Line number O may net be used. 


2. Line numbers are used by BASIC to arrange the program lines 
sequentially. The program will be executed in order of 
ingreasing line number regardless af the order in which they 
are entered. 

Ж. А line number may be used only ance in any given program 

4, а previously entered line may be changed by simply 
re-entering the same lina number along with the corrected 
line, Typing а line number followed immediately by a 
carriage return deletes that line. 

ч. Frogram lines need not be entered in numerical order because 
BASIC will automatically put them in ascending order. 

6. A line cannot contain more than 128 characters including 
Spaces, | 

7. Spaces are nol processed by BASIC unless they are part of a 
character string (1. е, enclosed in quotation marks). The 
use af spaces із optional. The line io LET А = 10 is 
the same as the line LOLETA=106, Spaces make the line more 
readable, but take longer for the interperter to process and 
сопзите more memory. Numbers may nat contain imbedded 


apaces. 


0 
E 


Multiple statements on a single line are permitted and must 
be separated by a colon ":". The statements are processed 


from left to right. For example: 
10 бш4: Бе7: DATE: PRINT C 
is equivalent То: 
10 А=4 
20 B-7 


ЗО LATE 
40 ЕКТМТ C 
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DATA FORMAT: 


The range of numbers that сап „Бе represented is 1. 0 Ё-99 ta 
v. wauwouco EI? where ЕЗУУ represents 10 to the power FY. 


Numbers are retained to ап accuracy.of nine decimal digits and 
are internally truncated (last digits dropped) ta fit this 
format. Numbers тау һа entered and displayed in three formats: 


integer, decimal, and exponential. For example: 
1224 12.3 1224 Ё-2 


NUMERIC VARTABLES: 


Variables are represented in a statement Бу any single alphabetic 
sharacter or any single alphabetic character followed by a number 
О through 9. 


Examples: Х, Y, 2, Xu, іш 


STRING VARIABLES: 


String variables may contain a maximum af 178 characters. А 
string length command is available. which allows the maximum 
string length to be set at the beginning of the program. if the 
string length is not explicitly defined using the STRING command, 
BASIC assumes a string length of 22 | characters. Reter oo to the 
STRING command description for а detailed description of its use 


Examples. of string variables: ХФ, Ү%(7), 2Ф63.2) 
These string variables are all distinet from numeric variables 
having the same name. For example, ХаУуО2,  X$z"PULLY"; YOR) SZ 


and  YS((S)-"CRACKERS" are all legal and may appear in the same 
program.  : ; | | 


STRING СОМСЕТЕМАТТОМ: 


Strings may be cancatenated (joined together) using the 
сопсаТтепа? топ symbol "+", For examples: | 


10 Xargay" 

20 Уфе" вазтс" 

ЗО Z$-zX$ + VS 

40 PRINT 7% 
Will print: CSS BASIC 


The total length of the strings to be concatenated may not exceed 


the STRING command. 
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CONTROL FUNCTIONS: 


Control characters such as CONTROL © or CONTROL X are typed by 
holding down the CTRL key while typing the specific letter. 
Control characters are not displayed оп the terminal but are 
accepted by the computer, The control functions may be assigned 
different characters more suitable to the users system | Refer 
to the appendices for specific details. 


BREAK - 
Typing CONTROL C will cause BASIC to halt its current 
operation and То respond with "BASIC". BASIC will then accept 
additional commands. CONTROL C may be used ta stap а LIST 
operation which 15 in progress before it is completed, ог То halt 


the execution of a program. If an МР-С card is being vaea ав the 
terminal interface, the user may have to hit CONTROL C several 


times before the terminal will respond. 


LINE. CANCEL = 2. 2 

Typing CONTROL X clears the current contents of the 
line buffer. If an error is made while making any entry on the 
terminal, either during program entry оғ data input during а 
program this character can be used to delete the line. The user 
may then re-enter the line followed by а carriage return. Ого а 
carriage return has been entered, however, the CONTROL X will по 
longer delete the lins. 


BACKSPACE - | 
| The CONTROL H (backspace) is used as a single character 
back space function. When a character has been typed in error, 
either during program entry or data input during а program, it 
may be corrected by typing the CONTROL H followed by the entry of 
the carreat character. ` You may backspace as many character 
positions as necessary. 
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BASIC COMMANDS: 


It is possible to communicate with thë empiute in BASIC by 


typing commands directly an the keyboard af the terminal. ^ Also: 
many statements can be executed directly using the direct mode of 
operation described earlier. In addition. there are several 
commands which may be used by the operator in order to 1151 
programs, run programs, save or load programs, ete. When BASIC 


is ready ta receive commands, "BASICH" will be displayed on the 
terminal. After each entry, the system will prompt the operator 
with a "tW". i | ‚у | DES 


Commands are typed an the terminal without | using statement 
numbers. After the command has been executed, "BASICH" will be 
displayed indicating that BASIC із ready oto receive another 
command from the operator. | | nau ; се с 


1151 - 

This command displays the lines of the current program, 
on the terminal. The lines are listed in ascending numerical. 
order Бу line number. A single line may ha listed, or all lines | 
within a given range may be listed. For example: р 


LIST | List the entire program 

LIST 30 | ^ o List only statement 30. 

LIST 30-100 List statements 3O through 100. | 
LIST #4 List entire program on terminal/printer. | 


connected to 1/0 Fort 44 


RUM - | ат | | | 
i Typing RUM, followed by a carriage return, causes thre 
program which is currently in memory to be executed starting with. 
the lowest line | numbered | line. The КЫМ | command resets all 
program parameters and initializes all variables to zara: 


CONT -, із ФЕ, 
The CONTinue command causes program execution to be 
resumed after a STOP statement has been executed If а program 
has been interrupted using а "break" "(control ©) command, 

exenrution may be resumed by typing CONT followed by а carriage. 
return. This command should not be used if a program error. had 
been encountered or if the program has been changed. The program 

parameters аға not changed by this command. 


NEW — 


This command causes. the user. program area and all 
variables and pointers to be reset. The effect of this command 
is to erase all traces of the previous pregram from memory in 
preparation for a new program. The CSS identification and BASIC 
version number will print, followed by "BASICH". | 
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TRACE ~ | | | | 
The TRACE feature is a useful debugging tool. Typing. 
TRACE causes BASIC to display te the terminal the line number of 
each statement as it is executed This allows the user to follow 
the sequence in which the program is being executed. Typing 
TRACE. again returns the system tu its normal mode of operation. 

The TRACE command may be inserted anywhere in the program оғ 
executed in the direat mode. 


SIZE - | 
The SIZE (DISK only) command returns the following 
information to the control port: 


AVAIL=(bytes of unused memory in decimal) 
PROG=(bytes used for program source) 
VAR=(bytes used for variable storage) 

` (after program has been run) 


MON - 

This command causes the computer ta return to the 
resident ROM monitor in the computer system. in the case of 
MIKBUG/SSMARTBUG this will output a carriage return, lire feed, 
and the "8" prompt character. I? the stack |pointer address 
(stored in #8008 and $6009) із nat altered tie. pressing reset), 
then typing "Б" will restart BASIC leaving the users BASIC 
program intact. The MON command may be inserted as a statement 
within a BASIC program. 


п Ut 


hts = 
The DOS (DISK only) command functions identieally as 
MON except that control is return to DOS, To re-enter BASIC, 
exit DOS and jump to ($0103), BASIC^s soft start. 


PORT - 
The command PORT = N defines the ТИП part which will 
Serve as the control part. M can be a constant. a variable, оғ 
an expressinn. All. massages, including BASIC^s "BASICH" will be 
sent То the port assigned by the FORT command and the BASIC 
program will expect all input from that port. 


| BEWARE 
If a port without a terminal is defined as 
the control port. you will lose control of 
your program. Breaks will always be accepted 
. from the control port. EE | 


Computerware considers the use af FORT to direct output ota a 


printer to Бе a POOR programming technique. Use the PRINT ЖР (FP 
= port na.) for this purpose. 
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BASIC nisk ахын FUNCT TONS: 

The following commands and functions are unique to RANDOM - BASIC. 
They are in a separate catagory from the disk file handling 
commands and functions because they do not require data files for 
their use. They may also be used in conjunction with file 
handling, and in fact, are quite useful in that area. 


FLIST - TES 
The FLIST (file list) command allows the BASIC user to 


list the file names stored in the disk directory without exiting 
to 0056. The format of this command із: FLIST CHa pee t. 
пытһвек>1Г, Sunit numbers, Typing FLIST alone lists the files 


stored on disk drive О, FLIST 2 will list. the file directory оғ 
disk 2. FLIST 4,1 will list the disk file directory for disk 
drive 1 оп port 4.  FLIST will not list. thé transient commands 
found in the disk directory. 22 


FDEL - | 
The FOEL (tile delete) command allows the user La 
delete disk files without exiting back to Düs6s to use the DELETE 
command... The format of the FDEL command is: FIEL <file list 
Separated by commas. 


ЕНЕМ - ; E | 
The ЕКЕМ (file rename) command functions just as the 
DOSS RENAME command does ta change the name of a disk file. The 
command format is: FREN Cold file name? “new file name "Note: 
Drive number is allowed only оп the “old file” parameter. | 


ЕСНК - 

The FCHE function allows the user to determine the 
absence or presence of a program or data file оп the disk 
without invoking an Error that would stop BASIC. The format of 
FCHK із: ЕСНК <unit number: ><file‘prog name>. -. since it is a 
function it must be preceded by a command The value that FCHE 
returns is identical іс those of the STATUS. function deseribed 
elsewhere in the manual. ' ; 


Examples: ТЕ FCHE 1: MASTER. FIL <> 0 THEN 2000 
or LET А = ЕСНК РАУКШ.. BAS 


FREE - 
The FREE function returns ta the user the number of 
free sectors on the diskette for the drive specified. The format 
is as follows: FREE X — where X is either a numeric variable or 


number in the range of О to 3, representing the drive (unit) 
number. To determine the number oof free bytes, multiply the 


number of sectors hy 124. Example: F. (PREEO) #124 will print Ж 
bytes free on drive 0. | | | 
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HOUSEKEEPING COMMANDS: 


The fallowing three commands, LINE, DIGITS, and STRING allow the 
user to define the associated parameters. Onee these commands 
аға used, the values assigned remain the same until the commands 
are used again оғ BASIC is reload from the disk. LINE and DIGITS 
сап Бе used more than ance during a program; STRING cannot, The 
default values for these parameters are listed іп APPENDIX 4. 
The system returns to the default values whenever the commands 
NEW LOAD or CHAIN are executed. 


LINES - 

The LINE= command specifies | the number af print 
positions in a line For example, LINE = 40 defines a line to be 
40 characters long. While printing, if the next position is 
within the last 25Х of the line length and a space is printed, a 
carriage return/line feed will be issued. This is done so that a 
number or word will not be divided at the end of a print line. 
To inhibit this function, just set the line length equal te more 
than 1254 of the actual desired line length. Setting LINE=0 
disables the line command. 


LINE — 
The LINE (DISK only) function returns to the user the 
value of . the line length currently in use either from system 
default (64) ar from the LINES command. 


DIGITS= - | 
This command is used 10 Specify the number of digits Lo 
Бе printed to the right af the decimal point. Any digits that 
appear beyond the number specified will be truncated. lf | there 
are not enough digits to fill the given length zeros will be 
used. DIGITS = O resets the system to the floating point mode. 


DIGITS ~ 
The DIGITS (DISK only) function returns to the user the 
value of the digits counter, which. was either set by the DIGITS= 
command or the system default of zero (0). 


STRING- -- | 
Executing the command STRING = N will set the maximum 
string length То N characters. BASIC will now reserve M bytes in 
memory for all string variables regardless of the actual number 
of characters which are entered for any particular variable. a 
maximum af 128 characters is allowed. If the STRING command із 
not used, BASIC will assume the default value of 32 characters. 
The STRING command сап be used only once during a program and, if 
used, must appear before reference to any string variable is 
made. For these reasons the user is advised to place the STRING 
command at the very beginning of his program in a one-time-only 
"housekeeping" type routine. 
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BASE - ; пре и E 
| The command BASE=0 will cause array subscripts to begin 
with the | number 0. The command BASE=1. will cause array 
subseripts to begin with the number 1 which is the default value. 
Random record numbers (RECNO) also are relative to the BASE- 
command. To conform to the proposed ANSI. standard, the БАЗЕ 
command may be entered in the format: OPTION BASE=. 


HOME - | : : 
1 The HOME comma rd will sand the home-up and 
clear-to-end-of-frame sequence to the output device | Appendix Е 
contains the location of where this string is located to allow 
you to change this to be compatable with your system. 


SKIP ~ : 
The SEIF command is used ta skip X print lines. SEIF X 
eliminates the need to use multiple PRINT statements. “ХУ” must 
be a decimal value between i and 255. This command sends BASIC- s 
carriage return line feed sequence to the output device. SKIF 
may be directed to any I/O port, using the following format: SKIF 
#Р, Х where P is the port number and X is the number of lines. 


WAIT - 
The WAIT. command provides the user with an easy way to 
program wait loops. ^X^ is a decimal value between 1 and 255 
The length of time represented by the value 1 is dependent upon 
the the speed of the users processor (usually between . 5 and 2.9 
seconds). А WAIT loop can be interrupted by the BREAK command. 


RJUST- ~ ; | 
The value af ^X^ in the command КЛ ТВА is the number 
of print positions te the left of the decimal point when printing 
а number. Leading zeros in the field are printed as blanks. To 
reset RJUST for left justification, set RJIUST=0, | 


БОЛТ - нг | И | 
The RJUST (DISK only) function returns to the user the 
value of the right justification counter, which was either set hy 
the RJUST= command or the system default of zero (CO). 
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SAVING AND LOADING BASIC PROGRAMS: 


Computerware^s BASICS were written ta allow programs to be saved 
and loaded using either disk, Kansas City Standard cassette, ок 
paper tape. Тһе Commands SAVE, LOAD, АРРЕМП, REPLACE, and CHAIN 
are RANDOM DISE BASIC only commands, while TSAVE, TLOAD. and 
TFEND аға in all af the Basics. 


SAVE ~ | 
This command is used to save programs to DISK. To save 
a file, the | user сап Туре either SAVE filename or SAVE 
followed by a carriage return BASIC will prompt | you for the 
file name it you did not enter it. To. ave a program on disk 
unit #1 or #2 simply prefix the name with. i: оғ 2:. 


LOAD - 
This command is used to load a program from DISK. The 
format of this command is the same as for SAVE. 


ВРРЕМП-- 

This command alse loads programs into memory as does 
LOAD except that the currant contents of memory are not cleared 
out. The program which is loaded is "appended" (added) to the 
program already in memory according to the line. numbers. on the 
appended program. Variable storage will Бе affected by the 
APPEND command - thus it should not be used as а command in a 
BASIC program but only in the immediate made. 


REPLACE - 2 
The REPLACE command provides the dual function of FOEL 
and SAVE. Тһе format is the same as SAVE but BASIC will first. 
delete the program file from disk and then save the current 
memory contents on the disk, using the same program file пате, 
CALITION: if the program file name is not on the disk an errar 
will occur. Also be sure that you really want to delete the 
existing file on disk prior to using REPLACE. 


CHAIN - | ; 
The CHAIN command allows опе BASIC program to call 
another BASIC program. The called program will automatically 
begin execution. The format of the CHAIN command is the same as 
SAVE and LOAD. A practical example of the use af the CHAIN 
command would be to have a master program call various selected 
programs which chain back То the master program after execution. 
Even though variable storage is cleared by the CHAIN. command, 
vou may use. a variable as the file name Cie. CHAIN A$). 
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TSAVE - Я E QUA 
The TSAVE command allows the user to dump the current 
BASIC program to cassette tape The TSAVE command is similiar to 
the Р command af MIEBUG - punch on/off commands are automatically 


sent to the recording device. The cassette interface сап be used 
in either a manual or automatic moter control made. lf^ in the 
manual mode, the recorder should be turned on prior to pressing 
carriage return, after typing the TSAVE command. TSAVE will 


output the entire BASIC source buffer onto the recording device. 
The source buffer in memory is unchanged by the TSAVE command. 


TSAVE allows file names to be entered in the following format: 
TSAVE "FILE NAME" ar TSAVE #3 "FILE NAME". The name will Бе 
output to the tape ahead of the source program 


падаш ~ 

The TLOAD command allows far the entering of previously 
recorded BASIC programs from cassette tape. The TLOAD command is 
Similiar ta the L command af MIRBUG - reader onoff commands are 
automatically sent, and either manual or automatic motor control 
ran Бе used an the cassette interface. Typing TLOADL followed hy 
a carriage return will transfer the source program from tape to 
the BASIC source buffer. The buffer is automatically cleare d ат 
the beginning of a TLOAD command. 


If TLOAD is used with the filename option (TLOAD "FILE NAME"), 
"only а source program with that file name will be loaded. If a 
file name was nat Specified, the first source program encountered 
Will be loaded. 


ТРЕМП — | © 
The TPEND command is identical `ta the. TLOAD command 
except that the currant BASIC buffer is. nat cleared. The 
information pravided for the APPEND command is also applicable to 
ТРЕМП. 


The TSAVE, TLOAD and ТРЕМП commands can all be used to work with 
any port. If, for.example, your cassette recording device is on 
the ACTA port tua, a TSAVE #2 command would be used. If а part 
number is not specified, the control port is assumed. 


NOTE: If your cassette interface does not have automatic motor 


control, you will have to manually turn the moter on and off when 
using the above commands. 
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ARITHMETIC OPERATORS: 


BASIC performs addition subtraction: multiplication, division 
and exponentiation. Mathematical expressions are evaluated from 

left ta right using the following operator prerade a. 
Parentheses may be used to override this normal precedence of 
opera tors, 


1) Exponentiation 
-4) Negation 

3) Multiplication and division 
4) Addition and subtraction 


The mathematical operators are symbolized as follows: 


^. . Exponentiation (up arrow character). 
Negate Cunary minus) 

Multiplication 

Division 

Addition 

Subtraction 


PRX | 


No two mathematical aperatars may appear in sequence and no 
operator is ever assumed. For example: 


10 C =s {++ 
20 (PL) LEI) are not valid. 


RELATIONAL OPERATORS: 


The following relational operators are used to compare tuo 
values. They may be used to compare arithmetic expressions оғ 
strings in an IF--THEN statement. | 


= Equal 
“> Not equal 
Ын Less than 


^ Greater than 
c= Less than or equal - 
= Greater than ог equal 


Examples: 
10 IF хе У THEN 220 


20 IF Q > R THEN PRINT В 2 
ЗО IF A >= 2 THEN GOSUE 100: GOTO 200 
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FUNCTIONS: 


Functions are not te be confused with commands. Functions may be 
used as expressions оғ as parts ОҒ expressions. Function 
arguments must Бе enclosed between parentheses. 


PEEK ~ 
РЕЕЕ CX) returns the decimal value contained іп the 
memory location specified Бу the decimal number X. For example, 
the statement Z=PEEKCI94) will assign to 2 the value of the 
contents of memory location 194 (hex CZ). 


FI - n | | | | 
FI returns the decimal value 2. 141592625. It may be 
used in any arithmetic expression. The FI function has по 
arguments. 
RND - 


RMDX) generates a set af uniformly distributed random 
numbers. There are two ways in which КМО can be used. 1) If 
KO, then a different random number between О and 1 will be 
returned each time КМО(Х) is used. 2) If X is not 0, | then the 
same random number will be returned sach time RNDCX) is used. if 
по argument is used then Х=0 is assumed. То yield random numbers 
within a range other than O to 1 use the following: 


10 PRINT COd-Ic-LD D #КМО(О)+Т) 


where the range of numbers is to be I through 4. 


ТАВ ~ | 
ТАБОХ) moves the print position to the Xth position te 
the right of the left margin. If the print position is already 
io the right af the Xth position then a carriage return ~ line 
feed will be first printed and the TAB will then position to the 
print location specified hy "X". This conforms ta the proposed 
ANSI standard. | The left-hand margin is print position #1. For 
example, to print АФ starting in column 25: | 


220 PRINT ТАВ(25): АФ 


The following function illustrates how a table of values can be 
printed with the right-hand column aligned: 


100 DEF FNA(GD = LENCGTRSCNT(GUDO) 
200 PRINT TAB(ZS~FNACJ) iJ 
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INT - 
INT(X) returns the greatest преден value. unen is less 
than X. For example: Е 


INT(&, 9) returns 8 
ІМТ(-7. 2) returns ВО 


аве СХ) returns the absolute value of the expression N. 


ABS(R 27) returns 6.27 
ABS (-6. 27) returns | 6. 27 


SGN ~ М. 
SGN(X) returns the sign (+ or =) of X. Examples: 
SOME. 3 returns 1 
SGN <i. 3) returns... mi 
SGNMtO) returns © 
SGNG-O) returns 0. 
POUS ~ 


POS returns the present column number af . the -print 
head “In fact, POS is: the inverse of the TAB funetion. For 
example: m 
io PRINT TABCD: Neos nte 

#0 IF РОЗ E 71 ТІНЕН» PRINT: as 


LEN — | 
| LEN(X$) returns the number of characters | currently in 
the string represented by ХФ. Example: за 


KLEN(C"EXAMPLE") returns. 7 
ASC. - 


АЕС) returns the decimal ASCII numeric value оғ the 
first ASCII character within thé string. For example: 


ASC ІК returns G3 
ӨЛС20"Ө")  raturns бш 


SEC" ABC") returns бй 


CHRE — 
| CHR$OX) returns a single character string equivalent to 

the decimal ASCII numeric value of X. CHR is the inverse of the 

ASC function. | Examples: | 


CHRS(G3) returns Т 
CHRS(65) returns A 
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VAL. = m оли 
Е | YAL) returns the numeric constant equivalent ta the 
string ХФ. VAL is the inverse of the STRY function, = An errar 
will oseur if ХФ is non-numeric. Examples: 
VAL ("SE4") | returns 5000 
VALC"17, 8") returns 17.8 


STRY. — шил m 23 нв 
| ЕТКФХ) returns the string value of a- numeric Value. 
STRS is the inverse of the VAL function. Example: 


10 LET G = 491 + 2 
20 LET M$ = STRE(G) = Now МФ = "4920" 


LEFTS - | 
LEFT(X$,N) returns the string of characters from the 
left most to the Nth character of X# For example: 


10 LET ИФ = "BIG BROWN COW" | | 
20 LET A$ = LEFT#&(WS,5) - Now AS = "BIG В" 


RIGHTS — "E БЕРЕ E "EET 
шан RIGHTS X$ N) returns a string of. characters «| from the 
Nth position to the left of the right most character through ‘the 

right most character. For ехатрі е: Dec | 


10 LET РФ = “BIG BROWN COW" | 
20 LET AS = RIGHTS (P$ 5) - Now АФ = "М COW" 


MID ~ . сн . eu E 2 
MID$OAS$ X, Y) returns а string of characters from the 
string variable A$ beginning with the Xth character from the left 
and continuing far Y characters from that point. Y is optional. 
If Y is not specified, then the string returned is fron the Xth 
gharacter to the right of the beginning of the string thraugh the 
end of the string. For example: 227 TEM 


“RED, BLUE, GREEN" 
MIDS (РБ, 3, 10) 


10 LET ЕФ 
20 LET АФ 


ЕН 


The variable AS пош contains the string "LL BLUE, GRE" 


IMOLD ~ Ч | | E 
Us IMODOX,Y) | returns: the integer remainder af dividing X 
by Y. (DISE only) | ЕЭ mE E ще да 
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TRANSCENDENTAL FUNCTIONS 

Accuracy far the following mathematical functions is retained te 

Seven significant digits. The accuracy of the seventh digit is 

nat quaranteaed. The arguments oof SIN, COS, and TAN are іп 

radians rather than degrees. | ; i 
FUNCTION EXPLANATION 


SIN(X) Returns. the sing of X 


Еке ӨЗ Returns the cosine of X 
a ТӨМ(Х) Returns the tangent of X. 
ATAN(X) Returns the aratangent of X. 2 
LOG X) Returns the natural logarithm of X 
EXFOD Returns 4. 719282 te) to the Xth power. 
The inverse of LUGOX). 


SRC XK) turns the square root af X 


USER - 


The USER function is provided to allow the programmer to jump ta. 
а uier defined subroutine from a BASIC program. The statement 
OLET A = USER (X) transfers program control to а user written 
. machine language: program. Program control branches То the memory 


| location pointed to by memory locations $25 and $29. Хо is a 
numeric expression which. is then stored in a 7-byte series 
beginning at a memory location pointed ta Бу ФЗО and. $231. — This 


value may be modified by the user written machine language 
program То act as a data output from the program ar as an 
indicator that something must be done The user routine must 
terminate with a $357 (RTS), thereby transferring control back te 
the .BASIC. interperter. Additionally, X is пош set equal to the 
value stored іп the sever byte series stored in Ди locations 
pointed То by $30 and $31, d | : 


Wher BASIC isl oade d, memory lacations $25 and $27 point a 
location containing an RTS ($39) so that if the user function ii 
called it simply returns control to the BASIC  interperter. You 
must modify memory locations. $28 and $27 using РОКЕ ar MON 
command in order to take advantage: of the USER нне 

Format of the seven byte numeric агаа: 


Byte: | PUE 3 4 5 b 7 PE 


47” 


і = sign : 2 = ЕСІ number 0: Ви not used :. 4 = ек (ро nent 


+ во Standard BEDR  . | | Standard BED 
вас. 1055 Compliment Standard BEL 
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STATEMENTS: 
This section describes statements which san be used in BASIC 
programs. | нэ 


POKE ~ , 
 POKE(GX, Y) stores the value of Y at location X (both X 


and Y are decimal values). This allows the user to modify 
specific memory locations | during. program execution. Extreme 


caution should be taken while using this statement. It is very 
easy to accidentally modify the BASIC interpreter itself whieh 
would cause the program, the data, and the interpreter to be 
destroyed! | жээ 22 


. DIM ~ 2 Ё 
The DIM (dimension) statement allows the user До 
explicitly define the size of an array. An array is a collection 
of subscripted variables or strings. Üne and tua dimensional 
arrays are allowed with a maximum size of 256 X 2956 elements 
Сийеп using BASE=0). The DIM statement initializes all elements 
within the array to zero, шоо 


An array сап only be "dimensioned! onge in а program, hut need 
(not be dimensioned at all. If а subseripted variable 15 
encountered prior to dimensioning а default of 10 elements is 
established for the array. Only the variables A ~ Z followed a $ 
may be dimensioned far string arrays. 


Examples: 


10 DIM X30) assigns ЗО memory spaces to array X 


| (room for 22 numeris variables) 
20 DIM Zi% 3) dimensions a 12 ХОШ array for Z 


30 DIM ASC ISS) | E defines a 155 element string array 
| {room for 1955 strings. each of 
, maximum string length) 


REM ~ Ч . 
The REMark statement is a nonexeculable statement which 
gives the user the ability То document his program. By including 
remark statements with tha: program source the listing becomes 
more readable. The abbreviation for REM із colon (:), 


DEF - 
DIEF. FNACX) allows the user to define his own functions. 
The letter "A" can be any letter of the alphabet and the variable 
X must ba a non-subscripted variables. Once defined, the function 
FNA(X). can Бе used anywhere in the program just like any other 
BASIC functions. A function must be defined before а reference 
is made Lo it. | . 
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DATA AND READ STATEMENTS - | . 

A Data and read statements are used together to assign 
Values . to variables within a . pragram, Every time а, data 
statement is encountered, | the values in the argument field are 
assigned sequentially tu the next available position of а. data 
buffer. All data statements, по matter where they occur in a ` 
program are combined inte a continuous list. 


REAL: statements cause values in the data buffer to be accosssed 
sequentially and assigned to the. variables named in the READ 
statement. They start with the first data element from the first 
data statement, then the next element, and so on to the end of 
the first data statement. and then ta the first element of the 
second | data statement, ete. Each time a READ. command. is 
encountered, it reads: the next data value that has not been 
assigned to a variable. If a READ is executed and the data 
Statements are out of data, an errar is generated. С | 


Numeric and string data may be intermixed. ‘However, they must be 
used in the appropriate order oto assign the data to the 
appropriate variables, DATA and READ statements may be placed 
anywhere within the program, TE | | | i 


String data need nof be enclosed in quotes since the comma acis 
as the delimiter. However, if the string contains a comma, then 
dit must tbe enclosed in quates, For exampls: S . 


10 DATA. JANUARY, L7, 1973. 
20 DATA "SMITH, BOBBY", 5 
зо READ МФ, 0, Ү, МФ 

40 READ A. 


Тһе statements shown above are equivalent to the following: 


s ^. 10 LET M$ = "OANUARY" 

ped 20 LET D: 17... 
ЗО LET Y = 1973 
АО LET N$ = "SMITH, BOBBY" 
50 LET А 5 | 


RESTORE - . i on E 

| The RESTORE statement causes the data buffer pointer 
(which is advanced by execution of READ statements) to Бе reset 
То the beginning of the data buffer. For example: | 


10: DATA ALVIN, 17, KAREN, ZZ 
20 READ АФ, A. BS Е 

30 RESTORE 

80 READ СФ, С 


is equivalent to: . 


210 LET АФ "ALVIN" 


ша Do бол 17 E 
220 LET ВФ = "KAREN" : B = 22 


EH 


ЗО LET C$ = "ALVIN" : C 17: 
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LET = : за | 

The LET statement is o used to assign a value Те а 

variable. The use of -LET is optional unless the statement is 


being executed in the immediate mode... m the. immediate tar 


direct) mode, the LET is required. | For сатр es Lhe statement 
LET 2100 is the same as ІНЕ Statement Lx ае 


The equal sign does not “аваг saute tence as in mathematics, but 
rather the replacement operator. It means: replace the value oof 
the variable name оп the left with the value of the expression on 
the right side of Lhe equal sign. The expression on the. right 
can be a. simple numeric value cor ап expression composed of 
numerical. values variables, mathematical. aperatars . ar 
functions. i ®: | ИУ. ёо 


FOR --- NEXT STATEMENTS ~ EN Қалалы Дед | 
| The following is the format of the FOR - NEXT group of 
‘statements: i T E | 2 i мэ ра бй 


10 FOR 1 - ..; Tih... STEF 
хо. j 

зо. 

40 NEXT I 


The FOR ~ NEXT statements are used together for getting up 
program loops. А loop causes the execution of one or more 
statements for а specified number of Limes before exiting from 
the loop. The variable in the FOR statement oshowun above as "I") 
iz initially sat to the value of tha first expression. 
Subsequently, the statements following the FOR are executed. 


When the NEXT statement is encountered the STEP value is added to 
the variable and program execution is resumed at the statement 
Following, the FOR - TO statement. If the addition af the STEF 
results іп a sum greater than the expression that follows ТО, tie 
NEXT instruction executed will Бе the ane following the NEXT 
Statement| If no STEP is specified, the value of 1 is assumed. 
Tf the TO value is less than the initial value, the FOR ~ NEXT 
loop will) be execuled only. onc. For examples: 


10 FOR k= 21 То - STEP 25 

20 PRINT E; : ШЕ 

30 NEXT К 

AO PRINT "DONE" 

This example will print: 1 1.95 2 25 3 DONE 

Although expressions are. permitted for the initial, final, and 
step values in the FOR statement; they. will be evaluated only 
once (the first time the loop is. entered). The same index 
variable cannot be used in tuo different loops if the boops are 
nested together. When the statenent after the NEXT statement is 
executed. the variable is aqual to the last value assigned. ài. е. 
the value which caused the loop То stop (generally one greater 


than the То Valued. 
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STOP ~ 
The STOF statement causes the. program ta- halt 
execution. BASIC returns to the command mode and prints "GASIC#". | 
The STOP statement differs from the END: statement іп that it 
causes BASIC | to display the statement number where the program 
stopped The program can be restarted by executing a GOTO or а 
CONT command. The message displayed is STOP XXXX where XXXX is 
the line number where the program stopped STOP is often used as 


a debugging aid. STOP automatically closes all files. 


END ~ АК ж Um 
The END statement causes tha program to stap executing. 

BASIC returns te the command mode and prints "“BASIC#". END may 
be used more than once and need not be used at all. When 
executed. END closes all files ол» 


GOTO - | 
The GOTO statement is. an  uncondifianal branch’ which 
directs thé program flow to the statement number specified. Nate. 
that the statement number may Specified as: being the сеа af 


га mimetiese variable оғ ey Rete dii 
Examples of GOTA: 


Shen теу a | 100 GOTO 10 


200.1.ЁТ 1,4500 г GOTO L eu 
СОТО 1000 (direct mode ex есит оп) 
с вото 1100 | | 


GOSUB AND RETURN - 


The GOSUB statement causes the program to branch to а 
Specified statement number. It is assumed that this statement 
number is the start of a subroutine «The sequence of statements 
which make up the subro шїїн must be terminated with a RETURN 
statement in order to send the program back to the statement 
following the original GUÜUSLIB statement. Like GOT the 
destination af a GOSUE may be repre sented as a numeric variable 
or expression. | 


A subroutine is a sequence oof instructions which need То Не 


executed more than once in a BASIC program. To use such a 
equence, а GOSUB instruction is employed. — pon completion of 
the subroutine, control is returned statement following the GOS LIE 
Бу execution af the RETURN. statement. 


ма 
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А subroutine may use a GOSUB to call another subroutine which in 
turn may call another subroutine and so ОП. This proces is 
referred to as "nesting".  Subroutine nesting is limited То eight 
levels. MEN 


Regs 
бе 


Example of the use af GOSUE and RETURN: _ 


10 T0 | : Coe es G 
ZO Ра 2 50: GOSUE 100: PRINT. Co. 
30 Р = 


3.00: GOSUB 100: PRINT C . 
40 PRINT "TOTAL 857 ^ TE 
30 END | 
100 C = Е 
110 T= Т 
120 RETURN 


* 1.06 
+ с 


This program 92114 output: 


2.71 
га. AD 


TOTAL 95. 04 


ON N GOTO OR ON N GOSUB - 


. This statement causes the program to branch ta. a 
specified statement number depending upon the value of М. N may 
be an integer value or may be an expression. If if is an 
expression, the expression will Бе evaluated, rounded to an 
integer, and the program will then branch to the Nth statement 
number. For example: | 


220 ON N GOTO 700; 350, 490, 450 


This means: 


If N Fall through to next line 
If N GOTO 700. BED 


GOTO 200 

сота 470 

GOTO 430... -. 

an error will result 


H 

+, 

2 
MEH EE 8 
PRUE О 
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IF --- THEN - | | | a мээн с. 


The IF statement is used ta contral-praogram execution 


. depending upon specified conditions. lf the — relational 


expression after the IF is true then the program performs the 
statement after the THEN. . If the conditional after the IF. is 
false, pragram execution continues with the statement on the next 
line after the IF --- THEN statement. The statement after THEN 
may be just a line number, which will cause program execution ta 
GOTO the line specified. All multiple statements on the same 
line as an IF -- THEN will be executed if the relationship tested 
trus. 


For example: 
10 IF А=9 THEN GOSUB 100: GOTO 230 


This statement will perform the GOSUB and then will GOTO 230 


when А is equal tao 5. 


The logical operators "AND" and "OR" are nat supported in this 


Version of BASIC but may be easily handled using the IF --- THEN 


statemert. 
- / 
Ta perform: 


IF Вер AND Сей THEN 100 


. use the following: 


IF A=B ТЕ Cen THEN 100 


To perform the function: 


IF вев OR C-D THEN 100 
use the following: 


IF А-В THEN 100 
IF C-D THEN 100 
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INPUT УПАЛТРЫТ STATEMENTS: 


Any INPUT ar PRINT statement may Бе followed with. an WM where М. 
is the I/O port number (0-7). . M may be а constant, variable, с aor 
an expression, . If no port number is specified, the control port 
(part #1, or port #2 for SMARTBUG) is assumed. . If any expression 
follows othe part number. it must be separated by a comma. Far 
example: мэн | qr. 

; 730 INFUT 82. A$ 
220 PRINT #4, X, Y. 7 


|OINFUT ~ | 
The INFUT statement allows the user to enter either. 


numerical or String data оп the terminal during program 
execution For example, statement 10 INFUT X allows ane numeric 
value to һе entered. The statement 10 INPUT X$ allows one | 


string value, with a length up to that specified by the STRING 
отита nd. То һе entered. The values inputed are assigned То the 
variables specified in the INPUT statement. 


: Multiple inputs сай be entered by separating them with commas. 
If the expected number of values are nol entered, a " T" will be 
generated. The statement 10 INFUT "ENTER VALUE". X will print 
the message inside the quotes, then prompt with a " Т"... 


When the program comes to an INFUT statement, a " 7" is displayed 
an the terminal. The program then waits for the user tu respond 
by entering the requested data followed by a carriage return = If 
insufficient data is entered. the system then promptis the user 
with. another " 7", If a non-numeric character is entered when a 
numeric variable is required, the system will prompt the user 
with “RE-ENTER”. 


FRINT ~ Ё 29 | | 
; The PRINT statement directs BASIC ta print. either the 
value af the expression literal values. string values, or text 
strings on the terminal. The various forms of print requests may 
be combined an a single statement and separated by commas оғ by 
&emi-ecalons. If the statement is terminated with a semi-colon ar 
comma, the line feed / carriage return sequence whieh із 
normally issued by BASIC automatically at the and of each print 
Statement) will be suppressed and the next print statement will 
resume printing on the game line where the last print left aff. 


Examples: 
10 PRINT Skip a line 
хо PRINT А, В,С Print variables 8, В, and С auto- 
matically tabbed into 16 
character fields | 
О FRINT бо В; С Print А, В, and C with only 
one space separating them 
40 PRINT "FOR SALE" Print a message 
SO PRINT "ТОТАГ A Print the message # 
Value af variable А 
50 PRINT #4, X Print tha value of X an T/A port 4 


allowed hy the 


ы 
+ 
i 
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RANDOM AND SEQUENTIAL DISK FILE HANDLING: 


Тһе following seetian describes the disk file sapabilities of 
Computerwuare^s RANDOM DISK BASIC. Both the random and sequential 
modes allow the user to create true ^records^ in that string and 
numeric variables may be intermixed in the logical fashion that 
the data normally appears when. being processed by the user. | 


Sequential files are denoted by the use of file numbers О = ? and 
Random files use file numbers 10 = 1% The use of random access 
file commands and functions on sequential files will result in а 
disk error and termination of the Basie program. — ыг 


Random access recordas are fixed length records во that they may 
be updated in place. This is | accomplished by using a 6 byte БЕП 
format for the numeric variables and forcing all strings to the 
size specified by the STRING= command. . Thus it is important for | 
the user to PLAN the record definition for a random file, because 
once created, all programs accessing the. file must have. the same 
string size as the create program had. 


OPEN - ; | i 52 
The command OPEN #¢FLN). (FILE SFEL) із used to open a 


disk file The file number, (ЕМ), is an expression. that must 
evaluate to the rarge O- through. i7. The file specification, . 


(FILE SPEC), must Бе string variable or string literal which 
supplies the file name in standard DOS6S farmat. 


For sequential files. the type of file access (read ок write) 
will be determined by the first usage af the file after opening. 
Random files are ОРЕМеЧ for both input and output. Gefore à 
. BASIC program can read input or write output) toe a file the file 

"must have previously beer opened Бу the OPEN statement. | 


Before а RANDOM file can be opened, it must first he created: 
using the CREATE statement. : xL x | га 


Multiple files may be opened with the same OPEN statement Бу 
using variables. for (РМ) and. (FILE. SPEC) and repeating the 
series of statements. Far example: | 
10 INPUT "NUMBER OF ЕЕЗ" Е 
XO FOR. I = 1 TO F. 22 
30 INPUT "FILE МАМЕ", FS 

40 OPEN #1 ЕФ 0. es 

SO NEXT I. 
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CREATE - . rrr ae Е 

Format: CREATE #¢(FLN). (FILE SPEC), (# OF RECS), (HEYTES/REC) 
The CREATE statement is used for the creation af пеш random 
access files. Тһе file number . must ре a. random aceess - file. 
number (10-19) ‘and file spec, as described above The number 
САҒ records is either a numeric variable oor constant specifying 
the size, сіп records that the user wants allocated for the 
random file Тһе number af bytes / record. is calculated as 
follows: . 7 DEE 2n : | АГА: 1 


Numeric variables ~ six (4) bytes: рек variable 
String variables o~ string length + 1 


Example: 
CREATES 12 s, CREDIT. нет, 200, 


Where  STRING=24 "und the. record is опе string (Ai) and five 
numeries variables (6 ж Б) for. ад record sige. of BA and an 
allocation af а file for 200 records. эж ыг 


A newly created file will be initialized to a «zero data state ~ 
nulls for strings and zeros for numerics. 


CLÜSE - : | 
The command CLOSE #CRPLND. #LFLN) >.. is for closing 
open files. The file number may also be an expression as with 
OPEN. The specified file number must have previously. been opened 
hy an ОРЕМ statement, Example: i aa 


100 CLOSE #1, #2 
READ — 


(22 The statement REAL @(FLN), (VARIABLE LIST) is provided 
to request data be read from a disk file. Input from a file-is 


taken an item at a time ~ as the program needs it. (UAR TABLE 
LIST) consists of one or more variables, ^ either string оғ 
numeric, separated by commas. lf. the receiving element ois. a 


string variable. it will receive the data fram the file up ta the 
maximum string length af 178 characters. . The line input ^ buffer 
for a single item from a file 13228 characters. i ; 


A string item over 128 characters will Бе truncated, and if mare 
then 128 characters. arae. contained in зол item of input, the 
buffer input iL. will he. terminated. 


If the receiving Er 15 а numeric va die the input is 
£&canned for a break character (а comma | or a null) and that 
portion of the input -— up to Тһе prec Eher tet СЕ - is then 
processed by a validation routine whieh verifies the number as 
being .a valid numeric value. If the number is invalid, Error #3 
CILLEGAL CHARACTER) will occur. 
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Random Access Notes: A complete record must be read on a single 
read statement =~ this applies toa all four random ^ access 
statements: READ. WRITE, GET and FUT. Auto increment af The 
record number CRECNO) takes place after the READ is completed. 
String size must be equal То that specified in the program whieh 
created the file and those writing to it. 


GET — 

GET is a random access statement identical ta REAL 

except. that auto increment of the record. number CRECNOO does МОТ 
GLL. 


RESTORE - 
The statement RESTORE РЕМО #LFLN);... causes the 
files associated with the list of file numbers to be repositioned 
to the beginning of the file Thus, the data in the file may be 
reread. Note that this statement functions for files just as the 
RESTORE decribed earlier functions far DATA statements, The file 
number. may be that of file which is open for reading (input) or 
writing (output). Ona random file, RESTORE resets the record 
number (RECNO) to the first record (BASESO is 0 ~ БА5ЗЕ-1 is 1). 


10 OFEN #1, "PART. MST" (Huotes are nat 
20 LET C = 5 required) | 
. 40 READ #1, 
50 IF STATUS#L <> О THEN ВО 
- 60 FRINT E 
TO GOTO 40 
20 RESTORE 81 
әй LET CeCc-1 
100 IF C <> О THEN 40 
110 CLOSE #1 
120 END 


The above program causes File Жі named "PART. МЕТ" to be opened. 
A counter (0) is set to 5 to keep track of the number of Limes ше 
go through the file Data is then read and printed until. the - 
status із non-zero (generally 4 Жоғ EDF). The file. is then 
restored Crewuound). The counto C, is decremented and if the 


result is not O the process is repeated until the count doses 
hecome О in which case the file is closed and the program ended. 


This | example could be adapted to listing a file just created 


The RESTORE after the write sequence will close the file, rewind 
the file, and open the file for reading. 


SCRATCH FILE - 

Tha. SCRATCH statement is used to remove an existing 
file from the current disk directory and then re-enter it inte 
the directory. After the file is re-entered inta the directory 
it is opened for output (Quriting). The old file is lost from the 
disk and a new file with the same name is prepared to receive 
data. A file that has been opened for input (read) cannot be 
acratehed until it is closed and then reopened. 
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SCRATCH is an ILLEGAL statement for a random file. since it is 
always opened for bath input and output — to delete a panum file 
рагпанатау from the disk, use the FEL c omma nd. 


10 OPEN: #1, FILE. RNG 
хо SCRATCH 81 
ЗО FOR 141 TO 10 
40 WRITE #1, RNICO) 
SO NEXT I 
40 RESTORE #1 
г то READ 41.1 ' i 
SO IF STATUS #1 = 6 THEN 110 
20 PRINT I 
100 GOTO 70 
110 CLOSE 41 
140 END 


This program apens a file called "FILE. КМО" and clears out all 


éxisting data with the serateh command. Then it writes Тел 
random numbers ta the file. closes ій, and then ER s file 
for reading with the RESTORE statement. The random number atre 


read. and printed until the end of file is encountered (STATUS = 
А) at which time the file is closed and the program ends. 


WRITE - ; 
The statement WRITE SCOFLBDO, (VARIABLE LIST) allows the 
writing of the data indicated in the variable list to a disk 
file. The variable list may contain either string or. numeric 
variables, separated by commas. An errar will occur an the first 
execution af the WRITE command if the file specified currently 


exists оп the disk. To insure the availability of the file write 
access, use the SCRATCH command which will prepare the file ta 


receive the autput. 


For random access files, a complete record must be оп а single 


WRITE statement. The reeard number | (RECNOO) will he auto 
incremented after the completion af the WRITE statement. As 


mentioned previously the. string size must be the same as that 
&pecified in the program which created the random file 


PUT ~- 
PUT is a random access statement identical to WRITE 
except that auto increment of the record number CRECNO) does NUT 


STATUS - 
STATUS #¢(¢FLN) is a function allowing for monitoring of 
error status. of any specified file number. . The status most often 
‘used is the end-of-file (EDF) which has a value af & . The status 
number ia that number returned hy the disk file management 
system Refer to the BFD-68 SYSTEM MANUAL for other . values, 11 
is a good idea to check the file status after а READ at least for 
end of file - т "mE 
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Random access files do по, have ап end-of-file status — the 
functions RSIZE and RNEXT have been provided so that both file 
size and the record number (КЕСМО) positioning can be monitored 
by the user. NOTE: After the last record in a random file. has 
been read or written to, the record number (RECNO) will remain 
positioned оп the last record = ait obviously can not be 
auto-incremented. 


RSIZE ~ 
КЕТЕ is -a function that returns ta the user the size 
of a RANDOM file in records. This should be used during random 
fila processing tu insure that: the record number | (RECNOD 
requested is within the boundaries of the file. 


Example: IF КЕСМЕННО 2 RSIZE#LO THEN Cerrar message ~ ate.) 


KNEXT - INE | ay ии 
: КМЕХТ is a function that returns to the user the value 
of the highest record written in the random file plus one, This 
is typically the next available record “slot: to be written inta. 
If you are using a method of loading the random data base other 
than sequential, the RNEXT function may return a value that would 
not reflect the next available "slot". Assuming а sequential 
load, the following example shows how to add records io an 
existing random file without  aver-writing any existing records: 


0010 SET КЕСМОЯ 12 = RNEXT#IS set КЕСМО to next available 
0020 WRITESi13, АФ, BS, C$, X, У, 2 WRITE record/auto increment 


SET is used to assign a value із the ОКЕСМО  fummand 
(both function and command). | 


RECN - | T | 
The RECN fummand serves the dual purpose of informing | 
the user the current position of the record pointer, and allowing 
the user То move the record pointer to any location within the 
random file. То assign a value to КЕСМО, the SET verb is used as 


follows: 


SET RECNOR1Z = “апу numeris expressed огу 
КЕСМ can also he interrogated, printed, ete. as a function: 
SET RECNOHIZ = RECNO81Z + 4 


IF БЕСМО415 > SS THEN 2000 
PRINT ВЕСМО#17? / FI i 
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CASSETTE: FILE HANDLING STATEMENTS: 


OPEN FILE — m | 
For INPUT - OPENI "FILE NAME" 


For OUTPUT - ОРЕМО "FILE NAME" 


The FILE. NAME may be any name and may have a length up 
to 60 characters. It may also be represented by a string 
variable. When opening for output, the file name is written inte 
а Special header record at the front of the file | 


When opening far input, BASIC begins reading the input tape, 
looking for a header record with the requested file name in 11, 
BASIC will print on the control terminal the names af any files 


that it passes while looking for the requested fila NOTE: The 
BREAK feature oof BASIC IZ NOT FUNCTIONAL WHILE SEARCHING FOR AN 
- INPUT FILE МАМЕ. If you have given BASIC. an incorrect file name, 


the only way То regain control af the computer system is ta 
press "RESET^ and than re-enter BASIC at HEX ADDRESS $0103. 


Below are sample input and output routines using file handling: 


0010 INPUT "INPUT FILE NAME "ЕФ 
0020 ОБЕМЪТ ЕФ 

DOTO TREAD АФ : IF EOF <> О THEN END 
0040 ЕКТМТ AS : GOTO 30 


0010 INFUT "INFLT FILE NAME 9, Еф 
0020 ОРЕМО ЕФ | 
0030 FOR X = i TO 1% 

0040 TWRITE X 

осо NEXT X 

0060 CLOSE 


CLOSE FILE ~ 


The CLOSE statement is far OUTPUT FILES ONLY. CLOSE 
will cause the last file control block to be written out ta 
cassette and set an end of file indicator in the file. 


EOF ~ 


The EOF funetion is used tao determine whether an input. 
file has more data to be read or is at the "End Of File, When 
EOF is equal ta ZERO (0) the file still Наз data ~ when EOF is 
NON-ZERO (220) all af the input file has been read. 
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READ FILE - 
TREAD (VARIABLE LIST) 


This statement specifies that data із to be ^read^ from 
the cassette file. Input from a file is taken an item at a time 
- ав the program needs. it. (VARIABLE LIST) consists of one оғ 
more variables, seither string or numeric, separated by commas. 


If the receiving element is a string variable, it will receive 
the data from the file up to the maximum string variable length 
of YO characters, Тһе line input buffer for a single item from a 
file is 90 characters. | | . 


В string item over YO characters will Бе truncated. and if more 
than ¥O characters are contained in a single item of input, the 
buffer input processing will be terminated. 

If the receiving element is a numeric variable, the input is 
$&canned for а break character (а comma оғ a null) and that 
portion of the input — up То the break character - is then 
processed hy а validation routine which verifies the number az 
being a valid numeric variable. Іт the number is invalid, Error 
z (ILLEGAL CHARACTER) will осомк. | | 


WRITE TO FILE ~ 
| TWRITE (VARIABLE LIST) 


The TWRITE statement allows writing data contained in 
the variable list. This list may contain either o string aor 
numeric variables, separated Бу commas. String literals (text 
enclosed in quotes) may also. be written aut. with the. TWRITE 
Statement. nu HA 


ADDITIONAL NOTES: 


The TWRITE statement will display the data being 
written out оп the control terminal - on the same line (line feed 


nat given). TREAD will not display оп the control terminal (the 


software echo is turned off). Motor control is essential for 
proper operation of file handling statements. 


The input routine must be a reverse mirror immage af the output 
routine used ta save the data initially. For example, if you 
write out three variables with a single TWRITE statement  (TWRITE 


М.М); you must read back these variables with a single TREAD 


statement (TREAD А, В,С). The most flexible method. is ta only 
write or read a single variable with any TREAD оғ TWRITE 
statement. 


Although the file handling statements will not give an error 


message when used in the immediate mada, it is nat recommended to 
Та use this mode of operation — nor is it guaranteed to work... 
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AUTO. КИМ: 


Tt is possible for the user to save а лору of BASIC along with 
the source of a BASIC program and RUN or mall. as а transient 
command, the saved file and have it immediately begin execution. 
The transfer address for AUTO RUN is $0106, the first loaction to 
save 15 $0000, and to determine the last address to save, examine 
locations $0022 and $0023, 


Thus, the steps to make an autao-run file are: 
|) Load BASIC and create (or load in) the file То be autao-run. . 
X) Type DOS to exit to the operating system 


3) Use the resident КОМ Monitor (MIEBLG, SMARTBUG, ...) 
ta examine locatians зООТЕ and ФОС, 


4) Restart 0568 by the warm start entry point 


=) Туре: 
SAVE, Sauto-run file names, 0,Zcontenis of $22, and $32,104 
(То make the file а transient file, add "$" following 106). 


&) The auto-run file is now ready То run 
RUN, Zauto-run File name 
ағ 
Saute~run file name> if the "$" was used 


If you append the auto-run file onto а «ору af DOSEER that does 
not have a transfer address Cuse find to get. beginning. and «ending. 
‘addresses c then save one without a transfer address), then you 
san “LINKS to this пеш appended file and, upon a cald start 
($6020), DOSAG; BASIC and your program will load and the program 
will automatically begin executing. Whew!) 


i. 
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APPENDIX ны 


сът REFERENCE OF INSTRUCT I ONS 


COMMANDS : FUNCTIONS ү 2 STATEMENTS 


(used in direct mode) За (used in programs) 
ВВЭРРЕМП- «кацат | ABS РЕЕК je DATA - [RON GO SLIE 
##CHAIN | RUN BSC 2 FI SDIM | ., вом вото 

«сомт 20 SESAVE : АТАМ . FOS | END so ОВРОКЕ 

DIGITS #SKIF CHR$ . RIGHTS. 2 FOR-NEXT 22 #PRINT 

ҰНОМЕ 2 #5 TRING COZ — КМО FGETS. - READ 

*LINE .. тор ges DEF - зам МО #сота — ., REM 

® ТО ТРЕМП | EXF . SIN Nn: #1Е-ТНЕМ (3: RESTORE 

HLUUST оо: *TRACE OFF | INT SUR | INPUT , 2-2 RETURN 
ЗНН.ОВО Ҙ #TRACE ПМ. LEFT$. ТКФ #LET ; га ФТОР 

MEIN | TSAVE Pe LEN - ТАВ rx ; pe 

NEW += EWAIT LOG TAN 

“PORT `. *BGSE Fs MIDS . VAL. 

"RSITE ЕТ 5 ^ ТМС 

kenn di that can к | : # statements that can 

“Ве used within a ## Disk only be used in.the direct 

"program й mode. af execution 

“RANDOM. BASIC ОРЕМ CLOS E RESTORE SCRATCH FLIST nus 

5. COMMANDS | READ WRITE STATUS. EDEL 2 .FREN FREF 


FREE  .FCHE SET Оо БЕСМО: ЗЕТ FUT 
| RSIZE КМЕХТ CREATE. е 
с \SSETTE FILE COMMANDS: . OPENI ОРЕМО CLOSE TREAD TWRITE EOF 


NOTE: All. ОРЕВ зван be abbreviated | by using as тапу: сағ the 
first letters as required to provide uniqueness and then a 
period 6.3. ie FLIST = FL. - ектмт mop E стра, 


MATHEMATICAL OPERATORS RELATIONAL OPERATORS 

S ECHO NU акеп. - Equal: : 
ол Negate <> Not equal = 

ж Multiplication {Less than 

/ Division 2-2 > Greater than 

+ hddition &= Less than or equal 

- Subtraction mr Sater than or egual 


FRECEDENCE OF OPERATORS 


ti) Exponentiatioan 

(2) Negation 

(3) Multiplication or Division 
(4) Addition or Subtraction 
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CHARACTER CONVERSION TABLE 


ға 
m 
= 
m 
маи 


ASCII CNTL HEX DEC ASC 
NUL. е 00 00 ; 
Зон А 01 Ol | 
STX E 04 2 : ЖЕ 4G 


гел 
к 
к 
2 
m 
x 
è e 
ui m 
СІ 
T 
(0 


ы 

e 

+ 

Li 
қамты. 

а 

di 


ETX с o3 o3 / zF 47 3 
ЕОТ D o4 04 о a да "i 
ENG E 05 05 i 31 49 SD c 
ACK F 0% оё 2 Bz "50 ЗЕ 
BEL G 07 07 з aa 51 E: ЗЕ 
35 H 5 оз 4 34 mx , AO 
HT I ov. OF % 35 33 E 61 
LF 1 On ` 10 & 2% 54 b ex 
VT к oB 11 7 37 қыз ЯГ: ыз 
ЕЕ 1. ос iz g са Fide d. 54 
CR M ор із ә зе 57 е AS 
=й N OE 14 : a за + 66 
SI о oF 15 E 3m 59 2 67 
DLE F 10 іё сг аб 60 h EI 
DEL а 11 17 = СД 61 і 59 
ж.к 2 с > ЗЕ AE 4 АВ 
DC3 в 3 19 7 a 63 k 6E 
nca T 14 zo e 40 64 1 ЫГ 
мак U 15 zi A 41 ыз m 50 
SYN V 14 zz з 42 ха n AE 
ETE W 17 #3 c 43 67 o  . 6F 
CAN X & 24 nh. 44 48 p 70 
EM Y 19 25 СЕ 45 69 4 71 
SUE 7 1A 26 Е A6 70 p r7 72 
ESC г 1E 27 G 472271 vi TS 
Ез Ч ic: zu H 48 72 t 74. 
BS 0.1 10 29 OI 49 73 u. 78 
RE e ЇЕ з J АА 74 " Th 
us = LiF 3 ко 4B 78 ИТ 77 
SP zo 22 L AC 76 к 78 
! 21 33 M 40 77 y 7? 
! 22 34 N AE (78 ETA 
# 23 Ес о 4Е 79 р 7E 
+ 24 | 36 BO FO 2) 7 
% 25 3 о 5l Si 70 
& 26 Есе R 52-2 Sx n | 7E 
с 272. С HY оз 58 өз . DEL 7F 
( ze 40 Т . 54: 84 JE e 
) 29 AL у 55. вэ 
ж TA 42 у SS am 
* zB 3 и 87 
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MEMORY Lica TIONS LIESEL BY GASIK 


DUZO 


0022 


0024 


DORO 


0100 
0103 
106 
0109 
Pa OE 
ODE 
озор 
OLOF 
0111 
01153 
0115 


бізі 


ey ny 
О122. 


оз 
0124 


0125 


MOTE: 


- 0021 


T OZI 


- 0048 


- 0027 
~ ОО29 


- бош} 


i 


O10 


-0010Е 
- 0110 
- 0112 
- 0114 


~ 0120 


Contains the start of BASIC program (source) 


Contains the next available memory location after 
the BASIC program source) нэ 


Contains the next available memory location after 
the BASIC source program and any defined variables 


Memory limit 


Contains the pointer for USER 


"Contains the address af thea present arithmetic 


value in use during a USER call 
Cold start address 

Warm start address 

futo-run address 


Size of the BASIC interpreter 


Number af the &ontral port 


170 definition byte for PROM/CASSETTE BASIC 


Maximum memory size available for BASIC Та usa. 
Starting address for ТИП ports | 

Address of home / clear end-of-frame tring 
Address of ERROR routine (Error Ж in ACCE) 
RESERVED for future jump addresses 

Line delete control character (CTL X) 
Character delete control character (СТІ. Н) 
Character delete ECHO character (NULL) | 

BREAK gontrol character (ETL C) 


I/0 port jump tables 


at 256 bytes of memory available are used as а 


string expression buffer and for the machine stack. 


ка FEM EX X3 


ERRORS MESSAGES = 


The following is printed when an error aceurs: 


ERROR # mmm | 
LINE мо. - DATA ON LINE 


--<-- Painter to location just past 
part af line that was processed 
prior to the error condition. 


PRETEREA Ó——— MG deis HANA PAHI Aade senen PAren кы фен нее жене ова: 


BESETE ERROR 


MEANING 


"renen ) 


Maximum variable length exceeded (over 25a 

Input error | 

illegal character or variable 

Missing ending " in print literal 

Dimension error 

Illegal arithmetic 

Line number nat found 

Attempt to divide by.O 

Maximum subroutine nesting exceeded (over G levels) 
RETURN statement ex есите without a prior GOSUB : 
Illegal variable 

lnresognizable statement ~ also common. dise command errat 
Farenthesis errar 


Mamary full 


Subscript error 

Too many FOR-NEXT loops active (maximum is &) 

NEXT X statement without prior FUR х=. 

Nesting error in FOR-NEXT 

Error in READ statement 

Error in ON statement маг 

Input overflow (more than 128 characters on input line) 
Syntax error in DEF statement 2. 
FM function error. Either syntax errar or ЕМ is nat defined. 
Error in STRING usage or mixing ef numeric and strings: 
String buffer overflow, оғ string extract toa lang 

I/O operation to a port which does not contain an 1/0 card 
VAL function error — string starts with a non-numerisc 
Cannot take LOG of a negative number. 2 

Error message error 
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DISKE FILE ERRORS 


ERROR MEANING 


30 File number is not in range of О through 19 
31 Unable to open file for write 
3 Attanpt to write ta file nat өрөг for write 
a3 Unable Та open file for read . l 
ла, Attempt to read from a file nat open for read 
35 Attempt to read data beyond end of file 
e Specified file failed to close s 005€ 
37 ^. Specified file failed to delete 7 
зэ Disk Directary error. т 
37 Disk Unit (drive) number error 
40 Lisk Rename (ЕКЕМ) error 
41 Unused at this time "E 
44 RANDOM file failed to create (disk space ~ already exists) | 
Ax RANDOM file failed to open : x» та 
44 RANDOM file failed to position (out of boundaries) 
43 ." Attempt to read from random file a numeric variable 
505. that was nat numeris (numerics on disk іп BOD format) 
46 Attempt to read from a random file a string variable 
| that was nat string data M | 
47 Insufficient record sige to hold data (total # of 


Variables greater than record size or string size 
has been changed since file was created) 


Error numbers 90-69 (sequential) and 70-79 (random) indicate that 
ПЕМ (the disk file handler) has detected an error in handling the 
file | number carresponding to the least significant digit of the 
number: 40-47, DFM^s own error code will also be displayed (зөө. 
the ВЕП-68 system manual for value of the DFM error codes). > 


CASSETTE FILE EFFE 


ERROR MEANING 


SE ^ Attempt to write ta a file not opened for write 
34 Attempt to read from a file not opened for read 


ог past EOF 


~ [nz ~ 


APP EMO x ED 


EA CAPE L. E OE E Lit Ee Pt ғалыс X сим 


DOT 
Cage 


с 


LOS 


прод 
. соов 


СООА 
сос 
LOOF 


со 


7E 


90 


FF 
DE 


Et 
FE 


тыу 


OD 
с005 


00 


Coos 
30 

O6 . 
COUS 


ж 
BEGIN. STX. ISAVE 


Жж 

+ E мг | : - Жэн 

+ THE FOLLOWING EXAMPLE OF HOW TO USE ШБЕК 

# MULTIPLIES THE NUMBER ^X" GIVEN - LISER(X)- 

н EY TEN AND THEN RETURNS ТО BASIC. . NOTE. HOW * 

# THE ^X^ IS REFERENCED. IN THIS PROGRAM — ` 

* THIS IS THE MOST COMMON MISUNDERSTANDING. 

ж ON HON USER WORKS. | ‘ 

* 

d sol. | M 

МРОЇМТ EGU $30 ADDR OF USER DATA” 

Pk 22 | й шилэн UNE 
око $0078... . ADDR OOF POINTER TO USER PGM- 
РОВ AJSTART SET UF POINTER То USER РОМ 

+ : : : . | FL M. 
ORG CODD 

Hos dee 

USTART JM BEGIN 

& n | оз: 

к SAVE AREAS FOR USER РОМ 7 

% 


TSAVE. FOE o 


SAVE THE INDEX REGISTER 


LOX  UPDINT LOAD X WADIA OF USER. DATA: 
INC оо X INC THE EXPONENT БҮ 1 

LOX ISAVE RESTORE THE INDEX REGISTER. 
RTS 1 RETURN TO BASIC 

ЕМИ 


Soco 
кома рээ нА oad fut em pm dmm al 


ммм 


me EED 


оосо оос 


APPENDIX F 
PARTIAL SOURCE LISTING 


0247 t 
0248 ж 
0249? ж 
0250 ж START OF BASIC 
0251 ж , 
OZ ORG $100 
. 0253 + | я 
о ЕП OAC? 0244 ENTRY JSR START 
BO 0870 0255 JSR RSTART 
7E OBE4 0256 JMF RUN 
ME AE E МЕТА 
Фа ЕЕ 0250 BUFBAS FDR SRCEEG 
01 0259 CNTPRT FCG 1 : 
0260 + D й 
0261 % CASSETTE/PROM BASIC -BUG BYTE” 
0462 + 
. 00 Оғыз 1О0ЕР ЕСЕ о 
0264 + 
О268 ок O=MIKBUG/SWTBUG-PIA Ci) 
0256 + 1=SWTBUG-ACIA (1) 
0267 s Z=SWTELIG-ACTA (Ci) 
0268 ж PIA. (0) 
OZ67 08 SsSMTBUG-ACIA (2) 
0270 ж 
od * NOTE: ABOVE IS CASSETTE/PROM ONLY 
0272 ж 
D && ОО 0272 MEMMAX FDE $6300 Е 
Е 80 ор 0274  IOSTRT FDE $3000 START OF I/O FORTS 
1 ОВ FC 0275 HOMSTR FDE ном. IS HOME Z CLEAR END-OF-FRAME 
3 OC 4E 1275 ЕККРМТ FDB ЕККОК ADDRESS OF ERROR RTN (# IN ACCE 
2 ж 
с 00 00 027% ЕрБ $0000, $0000 RESERVED FOR FUTURE 
э 00 OO 0279 FOG $0000, $0000 JUMP ADDRESSES 
р 00 oo 5257 ЕТЕ $0000, $0000 
: % 
1 18 0282 DELINE ЕСЕ %18 CTL X 
2 08 0283 DELCHR FCB $08 си. H 
3 00 0284 ЗЕСНО ЕСЕ $00 NULL. 
4 o3 3553 BRKCHR FCG $3 CTL C 
28 # 
0287 ж 1/0 FORT JUMP TABLE 
0259 « 
0289 ж FORT О 
0290 ж i 
0188 0291  JMPTAE JMF QUTACI 
7E 0178 0292 ЫМР INACTA 
7E 0160 О293 AMP ACTINZ 
0294 ж 
0295 ж PORT 1 
7E ELDL 0296 JMP OUTEEE 
7E ELAC 0297 IMF INEEE 
7E 0177 0298 ЧМР DUMRTS 
0299 
- 0300 ж PORT 2 " 
7E О165 0201 AME! ситаст 
7Е 0178 0302 ИР INACIA 
7E 0160 ӨзОоз JMF ACTING 
0304 
0305 # FORT 2 
?Е 0188 0306 JM оитаст 
7E 0178 0207 JMF INACIA 
7E 0160 0308 ЭМР ACTINZ 
ЗО? ж 
. 0310  * PORT 4 1 
7E ОВ: 0:11 IMF QUTPIA 
7E OLAS 0312 ЭМР INPIA 
0193 0313 МАР FIAINZ 
0314 ж 
222 0315 # PORT X 2 
7E 0183 0316 | JMP DUTP IA 
7E OLAS 0:17 IME INF IA 
?Е 0193 0318 JMP PIAINZ 
03197 ж 


CSS RANDOM BASIC. С ^ (CUMPUTERWARE ASSEMBLY 


% PORT 6 
OISE 7E 01 «МЕ OLUTPIA 
OLSE 7E 01 JMP INPIA 
0161 7E Oi » «МЕ PIAINZ 

+ PORT 7 
0164 7E 01 JMP OUTPIA 
0167 7E 01 „МЕ INF I 
0168 7E 01 JMP PIAINZ 

+ 

ж SERIAL ТУС INIT 

+ 
0160 DE 25 ACIINZ LOX РОКТАП 
016Е 96 ОЗ LDA A #503 
0171 А7 00 STA А 0, Х 
0173 86 15 LDA А #415 
0175 А7 00 STA A О,Х 
0177 3? DUMRTS RTS 

* 

M SERIAL 1/0 INFUT 
0178 DE 85 INACIA LDX ‘PORTAL 
0175 Аб 00 LDA à Ò, X 
017г: 47 ASR А 
0170 24 F9 BCC INACIA 
Oi7F AG Oi LOG A 4, X 
0181 84 7F AND А #Ф7Е 
018501 7F CHE A #%7Е . 
0185 27 F1 BEG INACTA . 
0187 01 МОР RTS FOR МО ECHO 

+ 

ч SERIAL I/0 СИТЕТ 

4e 
0156. DE 65 OUTACI LEX PORTAL 
DISA ES ОО LOA В OX 

{ean CS OZ BIT Е #7 

OLSE 27 FS BEG DUTACI 
0120 А7 01 STA А iX 
0152 39 N RTS 

+ PARALLEL 170 INIT 

% 
0173 ПЕ 85 FIAINZ LOX PORTAL 
0195 GF Ol CLE DX 
0197 &F ОЗ CLR 2» 
0199 ФЕ 00 CLR о, X 
OLVE GF OZ CLER 2, Х 
0191 63 00 COM Q, X 
Oi7F 84, ЗЕ LDA а SEE 
DIAL А7 01 STA A LX 
0185 86 ZE LOA A 4$2E 
0185 А7 03 STA à XX 
0187 29 RTS 

+ 

M PARALLEL I/O INPUT 
0148 DE #5 ІМРІА LOX РОКТАП 
DIAA ES ОЗ LOA в 3, 
OIRE ZA FA BEL. INFIA 
DIAE AG 02 па à 4, X 
0180 А7 02 STA А 2,Х 
9152 39 RTS 

к 

ж FARALLEL 1/0 ОЦТРЫТ 

+ 
OLES DE 55 GUTFIA LEX FORT AL 
0185 81 7F | CMP А #$7F 
0187 27 14 BEG OFT A4 
0189 OF SEI | 
DIEA А7 OO ста A OX 
OLEE C6 36 LOA B R$ IG 
DIEE ЕУ 01 STA Б LX, 
о1с0 Се ЗЕ LDA в ЗЕ 
0102 Е? Oi STA E j, X 
2104 v6 DO LOA A INTRP 
об O6 20 ТАР 
0167 ES Ol OPIAZ LOA B LX 
DIL? ZA FL ЕН. ОРТА 
DICE Аб 00 LOA à OX 
oic 29 ЮРІЗ4 RTS 


24 


я, 


@ 


CSS RANDOM BASIC - RGASZZ - COMFLUTERWARE ASSEMBLY 
0400 . 
BREAK ROWITINE -- CHECKS FOR ЕЛ. C 


О1СЕ 37 0404 BREAK FSH Е 
OlCF 36 ? 0405 . зна г 
oio DF 0406 STR ТОЗАМХ 
0102 ЕЕ OLOF 0407 Щи). ТОЗТКТ 
ол FA CE 0402 LOA А ТОТҮРЕ a 
0107 ӘБ 10 0409 GMI GREARZ мес 
0109 45 — 0410 ASL В 
DIDA 26 04 0411 BNE ARA _ 
біш AG 04 0412 LOA А АСТА, X МЕЗІ 
OLDE 20 04 5413 ERA BREAK 1 
> ж 
О1ЕО ZA O7 0415 BREAKO EFL BREAK Pici 
DIEZ ве OS 0416 . па à ӨСТӨӨ, X MFP Sz 
O1E4 47 417 BREAKL ASR A 
DILES 24 11 0413 BEL BREAKS 
01Е7 20 04 0419 ERA EREARS 
0420 c 
DLE? AG 04 0421 BREAKZ LOA A FIAD: X 
GLEB 2B ОВ 0422 2 BMI BREAKS 
ОЕП BD ELAC 0472 BREAKS JSR ІМЕЕЕ 
O1FO Bl 0124 0424  BREAK4 CMP А BRECHR 
О1РЗ 26 Q3 0418 ЕМЕ. ARE ARES 
О1ЕЗ 7E OB73 0212 «МЕР READY 
MEZ + | 
OLFS DE 7F 0428 BREAKS LOX LOSAVX 
ОКА 27 од ЕШ. A 
О1ЕВ 33 04:30 FUL В 
ОЗЕП 29 0421 RTS 
A 0432 жо 
ода «+ QUT HEX RTN 
2 0434 ж : 
ОЕП аё OO 0435 OUTH LIG A 0, X 
ОЕК SD ОП 0434 BSR ситни 
0201 A6 OO O437 c OS & OX 
O203 OS 0420 Nx 
0204 20 OC GAAT ERA ЕҢГІНЕ 
0440 # 
| 0441 ж GUT TWO HEX КҮМ 
0442 + 
0206 SO FS 0442 OUTZHS ESR ОИТН 
0208 ӘП ҒЗ 0444 BAR OU TH 
ог08 ве 20 0445  ülTZSF LOA А #ЗЕАСЕ 
ог0 20 ОЕ 0446 вка СТОН 
e 0447 # c M 
020Е 44 0448 DUTH. LSR A 
OzOF 44 0449 EE SR A 
0210 44 0430 LSR A 
0211 44 0451 LER А Е 
0212 84 OF 0452 OQUTHR AND а #$F 
0214 ӘБ 30 OA c ADD A #0 
0216 81 37v 0454 СМЕ A 4v 
0218 23-02 0445 ELS OUTCH 
OziA SB 07 0456 ADD A #7 
0457 « г en 
0458 sx OUTPUT CHARACTER ЕТМ 
0499 48 
ос 3 0460 DUTCH FSH E 
0210 36 0461. FSH A 
ОЩЕ ЕП AE 0462 BSR BREAK 
0220 BE 7F 0463 STX TOSAVX 
о222 DE ci 0464 LEX CITE TR 
0224 OO 0455 ASR о, X 
Ozz6 20 ПО 04060 BRA BREAKE 
0467 + : А ME 
O46t ж INFUT CHARACTER КТМ 
| 0469 4 
орга Dr ЗЕ 0470 INCH SIX ТОЗАМХ 
Qz20 37000 0471 PSH B 
oxzb ПЕ c3 0472 ЕВА INF TR 
0220 AD 00 047:3 41% о, X 
OZZF 36 0474 PSH а. - 
0230 20 BE 0475 BRA BREAK 4 


+ 

ч 
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HOW TO REDUCE EXECUTION ГІМЕ | 


pos 
та 
m 


Subscripted variables “require. considerable time 
non-subscripted variables. whenever possible. 


The number af calculations involved in the transcendental 
functions (ЗІМ, СОБ, ТАМ, АТАМ, EXP, and LOG) make them 
Slow. Use these functions only when necessary. 


BASIC searches far functions and subroutines in the source 
file. Flacing often called routines at the start of the 
pragram will reduce BASIC’ 5 search time. | 


Variables are entered into the symbol table. as they are 
referenced. BASIC then searches the symbol table each time a 
variable is used. Therefore reference a frequently called 
variable early in the source program so that it comes near 
the front of the tabla | 


m 


Numerics sanstants are converted gach time they ar 
encountered. If a constant is used often it should be 
assigned to a variable and the variable name used ing tea d. 


Multiple statements рег line take longer ta process than the 
same instructions on single statement lines. This. is an 
example of the classical trade off between space and speed. 


£n 


в: 


i 


un 
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MEMOR S LSAT O ТЫР EET EI 


REM statements use Space, so use them wisely. 
Each non-subseripted numeric variable uses 8 bytes. 
Each numeric array uses б bytes + 6 bytes for each element. 


If the default string length of SZ characters is used, sach 
non-subscripted string variable uses 34 bytes and each. 
string array uses 6 bytes + 32 bytes for each alemant. Lise 
the STRING command to explicitly allocate the size you real. 


An implicitly dimensioned variable creates a 10 X 10 array. 
If you do not intend to use all 10 elements use the DIM 
statement to explicitly allocate only the space you need 


Each BASIC line uses 4 bytes for the line number, 2 bytes 
for the encoded key word, i byte for tha line length, 1 byte 
for othe end of line terminators plus 1 byte for each 
aharacter following the key ward. Reduce memory Space Ву 
using as fes spaces as possible. 


+ 


Each Sequential. file opened takes 177 bytea = Random Files 
take 226 bytes per file opened Reusing the same file 
number (after the file closing) in Subsequent ОРЕМ 
Statements will save allocation of пеш space when the old 
apare is no longer required. 


| 
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LOADING BASIC - USING: Mikbug "L" and a 
Binary Load Program 


The following is typically how your terminal will look after you 
have loaded CSS BASIC. | 


2 * is the prompt 
+. in Mikbug 

eG O3 EO E1ZB 0100 Абау and Стан Био 
їз 


COMFLUTERWARE BASIC | Basies ID and 
VERSION: CASS - AD Version Number 


BASIC 
# # is the prompt 
in BASIC 


SEQUENCE OF EVENTS: 


Mikhug “#9 оп the terminal — you type "L^ = and turn the On-30 ta 
the READ status “locked on’ position (this is the far right 
position). After the "G^ (whieh ік on the tape) is displayed on 
ihe terminal put the ӨГ-20 read status switch back ito the center 
position. When the Binary Load iz completed, the following will 
be displayed on the terminal: 


с Оз ЕО БІЛЕ 0100 ADAX {same of these values may differ) 


Again the Mikbug ^f^ will appear on the Lerminal. You type 7435. 
This exeatues the BASIC interpreter whieh will display the 
Basies ІП, version number and prompt. You are now ready to use 
BASIC. 


The same Sequence of events follows for SWTBUG as shown above for 
MIKGUG, The reverse side of the CSS SUPER GASIC cassette has а 
binary and Mikbug load for the SMARTBUG operating system — which 
also works as described above — Regardless of which operating 
system you are using, if you have а problem with the binary 
loader, you should try the MIKGUG load before concluding that the 
cassette із in errar. 


USING BAZIC WITH THE DIFFERENT SYSTEMS: 


Appendix F shows the location and possible values for the “ЕИЗ 
BYTE’ ar IZO Definition Indicatar. The MIEBLG/SWTIDUG side of the 
cassatie is set for aptiaon 81, whieh is an ACTA control port in 
port #1. The SMARTBUG side of the cassette is set to option #3 = 
ACTA in port 82. If neither of these settings is compatible with 
your system you may either change the “BLIG BYTE- each time you 
lead ог, resave BASIC with your modifications included. | 


er 
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SYSTEM DEFAULT VALLES 


The following table lists the default values of system parameters 


that are set оп system initialization or on executing the NEW 
LOAD, ar CHAIN commands. 


G 


TRACE is turned off. 
DIGITS is set to floating point mode. 
RJUST is set to floating T ETT 
STRING. is set to 22. 


BASE is set to 1. 


LINE is set to 64 
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